home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / scsifo.z / scsifo
Encoding:
Text File  |  2001-04-17  |  5.6 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ssssccccssssiiiiffffoooo((((1111mmmm))))                                                          ssssccccssssiiiiffffoooo((((1111mmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ssssccccssssiiiiffffoooo - Show Failover status and initiate Failover.
  10.  
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      The command line syntax of ssssccccssssiiiiffffoooo takes two flavors depending on the use.
  14.  
  15.      ssssccccssssiiiiffffoooo ----dddd
  16.      ssssccccssssiiiiffffoooo ----ssss _d_e_v_i_c_e-_n_a_m_e
  17.      ssssccccssssiiiiffffoooo ----tttt _d_e_v_i_c_e-_n_a_m_e
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      The first form is used to dump failover status, while the second and
  21.      third are used to initiate failover. The _d_e_v_i_c_e-_n_a_m_e required when
  22.      performing a failover should be that of the a disk (raw or block) or a
  23.      devscsi device associated with the primary path of the group the failover
  24.      is being attempted on.  The difference between the ----ssss and ----tttt options is
  25.      that the former will choose paths that do not require a controller
  26.      tresspass in preference to paths that do, while the latter will choose
  27.      the next path in the list and automatically issue a tresspass command to
  28.      it.  For disk subsystems that do not have a lun ownership property, the
  29.      options are identical.
  30.  
  31.  
  32. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  33.      Dumping the current failover status:
  34.  
  35.      The following example shows a single SCSI RAID configured with 8 LUNs.
  36.  
  37.        ssssccccssssiiiiffffoooo ----dddd
  38.  
  39.        sample output:
  40.  
  41.        Group 0:
  42.          [P] sc4d2l7 (587)
  43.          [ ] sc5d2l7 (790)
  44.        Group 1:
  45.          [P] sc4d2l6 (579)
  46.          [ ] sc5d2l6 (782)
  47.        Group 2:
  48.          [P] sc4d2l5 (571)
  49.          [ ] sc5d2l5 (774)
  50.        Group 3:
  51.          [P] sc4d2l4 (563)
  52.          [ ] sc5d2l4 (766)
  53.        Group 4:
  54.          [P] sc4d2l3 (555)
  55.          [ ] sc5d2l3 (758)
  56.        Group 5:
  57.          [P] sc4d2l2 (547)
  58.          [ ] sc5d2l2 (750)
  59.        Group 6:
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssccccssssiiiiffffoooo((((1111mmmm))))                                                          ssssccccssssiiiiffffoooo((((1111mmmm))))
  71.  
  72.  
  73.  
  74.          [P] sc4d2l1 (539)
  75.          [ ] sc5d2l1 (742)
  76.        Group 7:
  77.          [ ] sc4d2l0 (531)
  78.          [P] sc5d2l0 (734)
  79.  
  80.      The current primary path is indicated by a [[[[PPPP]]]] in the left column. Each
  81.      LUN is shown as an independent failover group with two paths. For all but
  82.      LUN 0, the primary path is accessed via SCSI bus 4. For LUN 0, the
  83.      primary path is accessible via SCSI bus 5.
  84.  
  85.      Initiating failover:
  86.  
  87.      The following example shows the initiation of failover of Group 5 (see
  88.      above example). The primary path will migrate from SCSI bus 4 to SCSI bus
  89.      5. Note that the devscsi device name will be used for initiating the
  90.      failover.  It is possible to initiate failover using the full canonical
  91.      name, e.g.,
  92.      /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/2/scsi.
  93.  
  94.        ssssccccssssiiiiffffoooo ----ssss sssscccc4444dddd2222llll2222
  95.  
  96.        sample output:
  97.  
  98.        New primary path /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/2/scsi (869) (sc5d2l2)
  99.  
  100.      Another dump of the failover status shows that LUN 2 (group 5) has in
  101.      fact migrated.
  102.  
  103.        ssssccccssssiiiiffffoooo ----dddd
  104.  
  105.        sample output:
  106.  
  107.        Group 0:
  108.          [P] sc4d2l7 (587)
  109.          [ ] sc5d2l7 (790)
  110.        Group 1:
  111.          [P] sc4d2l6 (579)
  112.          [ ] sc5d2l6 (782)
  113.        Group 2:
  114.          [P] sc4d2l5 (571)
  115.          [ ] sc5d2l5 (774)
  116.        Group 3:
  117.          [P] sc4d2l4 (563)
  118.          [ ] sc5d2l4 (766)
  119.        Group 4:
  120.          [P] sc4d2l3 (555)
  121.          [ ] sc5d2l3 (758)
  122.        Group 5:
  123.          [ ] sc4d2l2 (547)
  124.          [P] sc5d2l2 (750)
  125.        Group 6:
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ssssccccssssiiiiffffoooo((((1111mmmm))))                                                          ssssccccssssiiiiffffoooo((((1111mmmm))))
  137.  
  138.  
  139.  
  140.          [P] sc4d2l1 (539)
  141.          [ ] sc5d2l1 (742)
  142.        Group 7:
  143.          [ ] sc4d2l0 (531)
  144.          [P] sc5d2l0 (734)
  145.  
  146.  
  147. FFFFIIIILLLLEEEESSSS
  148.      /usr/sbin/scsifo
  149.      /dev/rdsk/*
  150.      /dev/dsk/*
  151.      /dev/scsi/*
  152.      /etc/init.d/failover
  153.      /etc/failover.conf
  154.      /var/sysgen/master.d/failover
  155.  
  156. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  157.      failover(7M).
  158.  
  159. NNNNOOOOTTTTEEEESSSS
  160.      On bootup, if only a single path is found for a failover group and it's
  161.      _n_o_t the primary, auto failover may be performed depending on the setting
  162.      of the kernel tunable variable ffffoooo____aaaauuuuttttoooo____ffffaaaaiiiilllloooovvvveeeerrrr____oooonnnn____ssssttttaaaarrrrtttt. See
  163.      /var/sysgen/master.d/failover.  This does not apply to devices defined
  164.      within the /etc/failover.conf configuration file.
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.